home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Tools / WB / AntiBlanker / AntiBlanker.readme < prev    next >
Encoding:
Text File  |  2000-05-20  |  8.7 KB  |  213 lines
  1. Short:    A tool that disables your screen blanker when certain tasks are running
  2. Uploader: Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  3. Author:   Ghandi <ghandi@cremlinsoftware.org> and Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  4. Type:     util/blank
  5. Replaces: AntiBlanker.lha
  6. Requires: OS3.x and at least a 68020
  7.  
  8. *******************************************************************************
  9. *** IF YOU STILL REQUIRE OS2.x SUPPORT, V1.1 IS AVAILABLE FROM OUR WWW SITE ***
  10. *******************************************************************************
  11.  
  12. Why was it written?
  13. ~~~~~~~~~~~~~~~~~~~
  14. Because the screen blanker we were using would eat up too much CPU time when we
  15. were trying to burn CDRs thus ruining them, and we kept forgetting to disable
  16. it beforehand, so we thought we would get our Amiga to do it for us.
  17.  
  18.  
  19. How do I run AntiBlanker from Workbench?
  20. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21. Just double click on the AntiBlanker icon.  In order to tell AntiBlanker what
  22. tasks to look out for you must setup it's ToolTypes as follows:
  23.  
  24. DELAY=<the delay between checks (in 1/50ths of a second)>
  25. BLANKCODE=<the blank key code, see below>
  26. BLANKQUALIFIER=<the blank qualifier, see below>
  27. TASK=<the task name you would like to disable your screen blanker for>
  28.  
  29. e.g.:
  30.  
  31. DELAY=6000
  32. BLANKCODE=0x0062
  33. BLANKQUALIFIER=0x0004
  34. TASK=MakeCD
  35. TASK=PalomaTV
  36.  
  37. The above would disable your screen blanker when ever MakeCD or PalomaTV are
  38. running, and it will check to see if they are running every 2 minutes
  39. (6000/50/60 = 2 minutes), but
  40.  
  41.  
  42. How do I run AntiBlanker from the CLI?
  43. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44. Type the following at a CLI prompt:
  45.  
  46. <Path>AntiBlanker <Config #1> <Config #2> ... <Config #n>
  47.  
  48. Where <Config #n> are any number of configuration files, AntiBlanker will
  49. automatically append them all together.  The format of the configuration files
  50. are as follows:
  51.  
  52. Line1      The delay between check (in 1/50ths of a second).
  53.            Same as DELAY tooltype.
  54. Line2      The blank key code (see below).
  55.            Same as BLANKCODE tooltype.
  56. Line3      The blank qualifier (see below).
  57.            Same as BLANKQUALIFIER tooltype.
  58. Line4 .. x The task name you would like to disable your screen blanker for.
  59.            Same as TASK tooltype.
  60.  
  61. nb.  When using multiple configuration files, AntiBlanker uses the DELAY,
  62. BLANKCODE and BLANKQUALIFIER from the last configuration file specified.
  63.  
  64.  
  65. What are the blank code and blank qualifier?
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67. AntiBlanker works by putting 'fake' input events onto the input chain, thus
  68. fooling your screen blanker into thinking you've pressed a key when you
  69. haven't.  Versions before 0.4 used the Control (Ctrl) key for this purpose as
  70. we thought it was least likely to cause any conflicts, unfortunately we did not
  71. fill in the input event with a single Control, but instead we accidentally set
  72. it to <Ctrl> + <'> and this would produce 'trash' in a shell window and in some
  73. software.
  74.  
  75. As of version 0.5 you can specify the blank code and blank qualifier (see
  76. above), this allows you to program AntiBlanker to 'fool' the system with any
  77. key you like.  You can specify the codes as hex or decimal by copying them
  78. exactly from the tables below (the tables are not complete, but should get you
  79. started).
  80.  
  81. Blank codes
  82. ~~~~~~~~~~~
  83. Key               Hex Code      Decimal Code
  84. ---               --------      ------------
  85. Left Shift        0x0060        96
  86. Right Shift       0x0061        97
  87. Caps Lock         0x0062        98
  88. Control           0x0063        99
  89. Left Alt          0x0064        100
  90. Right Alt         0x0065        101
  91. Left Amiga        0x0066        102
  92. Right Amiga       0x0067        103
  93.  
  94. nb.  The above blank codes work on our A1200, although they may be slightly
  95. different for other Amigas (and possibly foreign keyboards), if you get 'trash'
  96. in a shell window while using AntiBlanker try a different code.
  97.  
  98. Blank qualifiers
  99. ~~~~~~~~~~~~~~~~
  100. Key               Hex Code      Decimal Code
  101. ---               --------      ------------
  102. Left Shift        0x0001        1
  103. Right Shift       0x0002        2
  104. Caps Lock         0x0004        4
  105. Control           0x0008        8
  106. Left Alt          0x0010        16
  107. Right Alt         0x0020        32
  108. Left Amiga        0x0040        64
  109. Right Amiga       0x0080        128
  110.  
  111. If you find one of the above keys conflicts with your software try another.
  112. nb.  the Caps Lock codes do not appear to actually affect the status of
  113. Caps Lock.
  114.  
  115.  
  116. Which blankers work with AntiBlanker?
  117. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  118. AntiBlanker has been tested and proven to work with the following screen
  119. blankers, although it should work with almost any screen blanker.  If you have
  120. tested it with a blanker not listed, please let us know the results so that we
  121. can update the list.
  122.  
  123. Blanker                           AntiBlanker version  Comments
  124. -------                           -------------------  --------
  125. extras:tools/commodities/Blanker  0.1+
  126. util/cdity/mcx280.lha             0.1+
  127. util/blank/ASwarmII2_0.lha        0.2+
  128. util/blank/Auror15a.lha           0.2+
  129. util/blank/BeyondTheDark.lha      0.2+
  130. util/blank/Blanker2.6.lha         0.2+
  131. util/blank/DesktopMAGIC.lha       0.2+
  132. util/blank/GBlanker36.lha         0.2, 0.3, 0.5+
  133. util/blank/GBlanker36_020.lha     0.2, 0.3, 0.5+
  134. util/blank/FlyingToasters.lha     0.2+
  135. util/blank/MTX.lha                0.2+                 MTX 1.5+ required
  136. util/blank/ShadowMaster.lha       0.2+
  137. util/blank/StarBlanker.lha        0.2+
  138. util/blank/SwazBlanker240.lha     0.2+
  139.  
  140.  
  141. Miscellaneous notes
  142. ~~~~~~~~~~~~~~~~~~~
  143. Task names are CASE SENSITIVE, you can find out the name of task via a tool
  144. such as Scout.
  145.  
  146. To stop AntiBlanker, send it a CTRL-C signal either via the Break/BreakName
  147. programs or by a tool such as Scout.  Please note that AntiBlanker will not end
  148. immediately but after it's next loop.
  149.  
  150. To get the best performance out of AntiBlanker (so that it uses the least CPU
  151. time), put the tasks that you use most at the bottom of the tool type list (or
  152. configuration files).  Due to the way AntiBlanker stores the task names
  153. internally it actually checks for the tasks in the reverse order to the how you
  154. specify them.
  155.  
  156.  
  157. Registration and contacting us
  158. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  159. AntiBlanker is 'email ware', this means that if you use it then you must send
  160. us an email.  As you can see this is a very small cost to pay.
  161.  
  162. Also feel free to visit our website at http://www.cremlinsoftware.org it hosts
  163. all the latest versions of our software (including BETA releases).
  164.  
  165.  
  166. History
  167. ~~~~~~~
  168.  
  169. Version   Date        Comments
  170.  
  171. 0.1       15.06.1998  · First public release.
  172.  
  173. 0.2       15.06.1998  · Fixed AntiBlanker so that it works with Garshneblanker.
  174.                         [Luca 'Hexaae' Longone]
  175.  
  176. 0.3       05.09.1998  · Fixed an Enforcer hit that was caused by our linked
  177.                         list class.
  178.                         [Luca 'Hexaae' Longone]
  179.  
  180. 0.4       14.09.1998  · Added user definable blank key.
  181.                       · Altered the code so it sends a KEY_UP event instead of
  182.                         a KEY_DOWN.  This should reduce the amount of conflicts
  183.                         with existing software.
  184.  
  185. 0.5 BETA  15.09.1998  · Added The BlankCodeFinder program to the AntiBlanker
  186.                         package.
  187.                       · Changed user definable blank key so that it is
  188.                         specified as a CODE and QUALIFIER, instead of just a
  189.                         QUALIFIER.
  190.                       · Altered the code so it sends a KEY_DOWN event like 0.3
  191.                         did, as we had forgotten this was necessary for
  192.                         Garshneblanker compatibility (oops).
  193.  
  194. 1.0       15.02.2000  · Finally fixed the Enforcer hit on startup (that only
  195.                         took 1½ years).
  196.                         [Luca 'Hexaae' Longone]
  197.                       · Configuration file(s) are now closed properly.
  198.                       · Added CTRL-C support.
  199.                       · A number of internal optimisations and recompiled with
  200.                         the new OS3.5 includes.
  201.  
  202. 1.1       05.03.2000  · Our linked list class has been enhanced and cleaned up
  203.                         for one of our other projects, so we have recompiled
  204.                         AntiBlanker to accomodate the new class.
  205.                         No real changes have been made to the program itself.
  206.  
  207. 1.2       20.05.2000  · General cleanup of the code which has reduced the
  208.                         executable size slightly and AntiBlanker should use
  209.                         ever so slightly less memory.
  210.                       · AntiBlanker does now work with MTX, thanks to it's
  211.                         author for rewritting the checking code :-)
  212.                       · We have moved from HiSOFT C++ to StormC, basically
  213.                         because StormC is still being developed.